PrestaShop Watermark CC Documentation
Documentation complète pour le module de filigrane pour PrestaShop (cc_ps_watermark) avec système de sauvegarde avancé, régénération automatique des vignettes et gestion détaillée des filigranes.Table des matières
- Introduction
- Installation
- Activation de la licence
- Panel de gestion
- Paramètres généraux
- Configuration du filigrane
- Système de sauvegarde
- Régénération des miniatures
- Gestion des journaux
- CRON et automatisation
- Gestion des polices de caractères
- Résolution de problèmes
- FAQ
1. Introduction
CC PrestaShop Watermark est un module avancé qui vous permet d'ajouter automatiquement des filigranes à toutes les vignettes de produits dans votre boutique PrestaShop. Le module offre un système complet pour protéger les images originales grâce à des sauvegardes automatiques et des outils avancés pour gérer le processus de filigrane d'image.Fonctions du module principal :
- Ajout de filigranes (texte et image)
- Système de sauvegarde automatique des images originales
- Régénération de toutes les vignettes avec filigrane
- Prise en charge des polices TTF non standard
- Traitement sélectif des types de vignettes
- Système détaillé d'enregistrement des activités
- CRON pour la régénération automatique
- Restauration d'images originales à partir de sauvegardes
- Interface administrative multilingue
- Système de licence entièrement fonctionnel
2. installation
Exigences du système- PrestaShop 1.7.0.0 ou plus récent
- PHP 7.2 ou version ultérieure
- MySQL 5.6 ou plus récent
- Extension GD pour PHP (pour la gestion des images)
- Droits d'écriture pour les répertoires img/ et modules/.
- 512 Mo de RAM au minimum (1 Go recommandé pour les grandes boutiques)
- Fonctions Imagettftext pour la prise en charge des polices TTF
- Télécharger le fichier ZIP du module depuis la boutique officielle cocos.codes
- Se connecter au panneau d'administration de PrestaShop
- Allez dans : Modules > Gestionnaire de modules > Ajouter un nouveau module
- Cliquez sur "Ajouter un module" et sélectionnez le fichier ZIP téléchargé.
- Une fois l'installation terminée, cliquez sur "Configurer"
- Le module crée automatiquement les répertoires suivants : backups/, uploads/, fonts/.
Info
Après l'installation, le module créera automatiquement les tables de base de données nécessaires (cc_ps_watermark_log, cc_ps_watermark_backups, cc_ps_watermark_processed), les répertoires pour les sauvegardes et définira la configuration par défaut. Avant de commencer à travailler, nous recommandons d'activer la licence et d'ajouter les polices TTF au répertoire fonts/.
3. Activation de la licence
Avant de pouvoir utiliser toutes les fonctionnalités du module, il est nécessaire d'activer la licence :- Après l'installation, procéder à la configuration du module
- Sélectionnez l'onglet "Licence
- Saisir la clé de licence reçue après l'achat
- Cliquez sur "Activer la licence"
- Une fois l'activation réussie, un message de confirmation s'affiche
- Toutes les fonctions du module sont déverrouillées
Avertissement
Sans licence active, le module fonctionnera en mode restreint - les fonctions AJAX seront bloquées et un message s'affichera en haut du panneau d'administration pour indiquer que la licence n'est pas active. Les fonctions de filigrane de base seront disponibles, mais sans les options de gestion avancées.
4 Panneau de gestion
Le panneau de gestion du module se compose de plusieurs onglets qui permettent une configuration et une gestion complètes :Principaux onglets :
- Paramètres - configuration du module principal, filigrane
- Régénération des miniatures - Outils de régénération d'images CRON
- Sauvegardes - la gestion des sauvegardes des images originales
- Journaux - l'historique des activités du module avec le système de filtrage
- Documentation - lien vers la documentation en ligne
- Soutien - lien vers la page d'assistance
- Plug-ins - extensions supplémentaires de COCOS
- Licence - gestion des licences de modules
5. paramètres généraux
Dans la section des paramètres généraux, vous trouverez les options de base qui contrôlent le fonctionnement du module :| Paramètres | Description | Valeur par défaut |
| Mise sous tension du module | Activation/désactivation globale du module | Arrêt |
| Activer les sauvegardes | Création automatique de copies des images originales | Sur |
- Module sur - les filigranes sont automatiquement ajoutés aux produits nouveaux et mis à jour
- Module éteint - les filigranes ne sont pas ajoutés, mais les filigranes existants restent intacts
- Sauvegardes activées - une copie de l'original est effectuée avant chaque modification de l'image
- Sauvegardes désactivées - les images sont modifiées directement sans copie
Conseil
Il est recommandé de laisser les sauvegardes actives afin de pouvoir restaurer les images originales si nécessaire. Utilisez l'interrupteur principal du module pour un arrêt rapide pendant les travaux de maintenance.
6. configuration du filigrane
Le module propose deux types principaux de filigrane avec une configuration étendue pour chacun d'entre eux :Type de filigrane
Deux options de marquage des images sont disponibles :
| Type | Description | Exigences |
| Texte | Filigrane textuel avec configuration de la police et de la couleur | Police TTF optionnelle |
| Image | Filigrane d'image avec prise en charge de la transparence | Fichier PNG/JPG/GIF |
Configuration des marques de texte
- Texte en filigrane - contenu à afficher (par défaut : "COCOS.CODES")
- Police TTF - une sélection parmi les polices disponibles dans le répertoire fonts/.
- Taille de la police - 8 à 200 pixels (par défaut : 24px)
- Couleur du texte - sélection de la couleur au format HEX (par défaut : #FFFFFF)
- Fichier image - Transfert de fichiers PNG avec transparence
- Aperçu de la situation actuelle - affichage de l'image actuellement utilisée
- Taille maximale - 2MB par fichier
- Formats pris en charge - PNG, JPG, JPEG, GIF
- Position du filigrane - 9 positions au choix (coins, centre, centre)
- Répéter le filigrane - duplication sur l'ensemble de l'image
- Transparence - 0% (invisible) à 100% (opaque)
Nous pouvons sélectionner les types de vignettes à étiqueter :
- Liste de tous les types d'images de produits disponibles
- Affichage de tout type de résolution
- Toutes les combinaisons sont possibles
- Défaut : tous les types sont marqués
Note
Si vous ne sélectionnez aucun type de vignette, le module marquera tous les types disponibles. La modification des paramètres ne s'applique qu'aux images nouvellement traitées - utilisez la fonction de régénération pour mettre à jour les images existantes.
7. système de sauvegarde
L'un des éléments les plus importants du module est un système complet de sécurisation des images originales :Création automatique de copies
Le système crée automatiquement des sauvegardes :
- Avant d'ajouter un filigrane à une image pour la première fois
- Pour chaque type de miniature séparément
- Préserver la structure originale des répertoires
- Avec des métadonnées dans la base de données
Le panneau affiche des informations utiles :
- Nombre total de sauvegardes - toutes les sauvegardes créées
- Produits avec sauvegardes - nombre de produits avec des images protégées
- Utilisation du disque - taille totale de toutes les copies
- Dernière sauvegarde - date de la dernière sauvegarde
Opérations disponibles sur les sauvegardes :
| Fonctionnement | Description | Commentaires |
| Restaurer toutes les copies | Restauration des images originales à partir de toutes les copies | Supprime les filigranes de l'ensemble de la boutique |
| Supprimer toutes les copies | Supprime définitivement toutes les copies du disque | Chirurgie irréversible |
| Restaurer les copies de produits | Restaure les images du produit sélectionné uniquement | Disponible pour chaque produit séparément |
Un tableau détaillé comprenant
- ID et nom du produit
- Nombre de sauvegardes
- Besoins en espace
- Date de la dernière sauvegarde
- Bouton de restauration pour chaque produit
Le système a été optimisé pour la performance :
- 20 produits par page
- Chargement efficace de grandes listes
- AJAX pour les opérations sur les copies
- Actualisation automatique des statistiques
Avertissement
Les opérations sur les sauvegardes sont irréversibles. La restauration d'une copie supprime les filigranes et la suppression d'une copie rend impossible la restauration des images originales. Il est recommandé de sauvegarder l'ensemble de la boutique avant toute opération importante.
8 Régénération des miniatures
Un système de régénération avancé permet d'appliquer des filigranes à des images existantes :Régénération manuelle
Traitement immédiat de toutes les vignettes :
- "Bouton "Régénérer les vignettes maintenant
- Confirmation avant le début des opérations
- Barre de progression avec informations sur le statut
- Messages de réussite ou d'erreur
Le système permet de programmer une régénération automatique :
0 2 * * * * /usr/bin/php /path/to/prestashop/modules/cc_ps_watermark/cron.phpFichier CRON
Le module comprend un fichier cron.php dédié offrant :
- Vérifier si le module est actif
- Fixation de limites de temps et de mémoire
- Exactement la même fonctionnalité que le bouton dans le tableau de bord
- Enregistrement des résultats dans la console
- Messages d'erreur multilingues
CRON peut également être utilisé via HTTP :
http://twoja-domena.pl/modules/cc_ps_watermark/cron.php?token=WYGENEROWANY_TOKENLe système de régénération a été optimisé :
- Traitement par lots de 10 produits
- Libération automatique de la mémoire
- Prise en charge des limites de temps (10 minutes pour CRON)
- Augmentation de la limite de mémoire à 512MB
Conseil
Nous recommandons d'effectuer la régénération pendant les heures où le trafic est le plus faible dans la boutique. Pour les grandes boutiques (>1000 produits), utilisez CRON au lieu de la régénération manuelle via le navigateur.
9. gestion des journaux
Un système d'enregistrement complet permet de suivre toutes les activités du module :Types d'événements enregistrés
Le système enregistre les actions suivantes :
| Action | Description | Informations complémentaires |
| process_image | Traitement d'une seule image | Chemin d'accès au fichier, état, erreurs |
| créer une sauvegarde | Sauvegarde | Emplacement de la sauvegarde |
| restore_backup | Restauration à partir d'une copie | Fichier restauré |
| régénérer_tout | Régénération de toutes les figurines | Nombre d'images traitées |
| produit_processus | Traitement des produits | ID du produit, nombre d'images |
Chaque entrée comprend
- ID du journal - identifiant unique de l'entrée
- Date et heure - l'heure exacte de l'opération
- Action - le type d'opération effectuée
- ID du produit - Produit connexe (le cas échéant)
- Statut - succès, avertissement, erreur, info
- Message - description détaillée de l'incident
Fonctions disponibles :
- Pagination - 50 entrées par page
- Tri - dernières entrées en haut de la page
- Nettoyage des grumes - suppression de toutes les entrées
- Rotation automatique - un maximum de 5000 entrées
Indication visuelle de la validité :
- succès - vert (opération terminée avec succès)
- avertissement - jaune (avertissements, erreurs partielles)
- erreur - rouge (erreurs critiques)
- info - bleu (informations générales)
Info
Le système conserve automatiquement un maximum de 5 000 entrées de journal. Les entrées plus anciennes sont automatiquement supprimées. Pour conserver un historique complet, nous recommandons d'exporter périodiquement les journaux de la base de données.
10. CRON et automatisation
Détails de l'automatisation des processus du module :Configuration du serveur
Pour configurer la régénération automatique sur le serveur :
- Connectez-vous à cPanel/Plesk ou via SSH
- Trouver la section "Tâches CRON" ou "Jobs Cron"
- Ajouter une nouvelle tâche avec la commande donnée dans le panneau du module
- Régler la fréquence en fonction des besoins (recommandé : tous les soirs)
- Vérifiez que le chemin d'accès à PHP est correct
Selon le serveur, le chemin peut être différent :
/usr/bin/php
/usr/local/bin/php
/opt/php/bin/php
php (si présent dans PATH)Différentes fréquences de régénération :
| Calendrier | Description | Commande CRON |
| Tous les jours à 2 heures du matin. | Recommandé pour la plupart des magasins | 0 2 * * * |
| Chaque semaine, le dimanche | Pour les magasins où les changements sont peu fréquents | 0 2 * * 0 |
| Toutes les 6 heures | Pour les boutiques fréquemment mises à jour | 0 */6 * * * |
| Chaque mois | Fréquence minimale | 0 2 1 * * |
Pour vérifier que CRON fonctionne correctement :
- Vérifier les journaux du module après l'heure d'exécution prévue
- Tester l'appel cron.php manuellement via un navigateur
- Vérifier les journaux du serveur pour les erreurs PHP
- S'assurer que le module est actif
Le fichier cron.php contient des éléments de sécurité :
- Contrôle de l'activité du module
- Validation des jetons pour l'accès HTTP
- Enregistrement de toutes les opérations
- Traitement gracieux des erreurs
Note
Le jeton pour l'URL CRON est généré automatiquement en fonction de la configuration de PrestaShop et fournit une sécurité de base. Pour une sécurité accrue, nous recommandons d'utiliser CRON via la ligne de commande au lieu de HTTP.
11. gestion des polices de caractères
Système de prise en charge des polices personnalisées TTF pour les filigranes textuels :Catalogue de polices
Les polices TTF doivent être placées dans le répertoire :
/modules/cc_ps_watermark/fonts/Le module ne prend en charge que les polices TTF (TrueType Font) :
- Extension : .ttf
- Vérification de l'existence d'un fichier avant son utilisation
- Détection automatique des polices disponibles
- Noms conviviaux basés sur les noms de fichiers
Polices de caractères suggérées :
| Police | Description | Meilleure utilisation |
| Roboto-Regular.ttf | Par défaut, moderne, lisible | Utilisation universelle |
| Arial-Bold.ttf | Audacieux, distinctif | Filigranes clairs |
| OpenSans-Light.ttf | Léger, élégant | Filigranes subtils |
| Impact.ttf | Large, solide | Protection contre le piratage |
Système automatiquement :
- Recherche les fichiers TTF dans le répertoire fonts/
- Génère des noms conviviaux (par exemple "Roboto Regular" avec "Roboto-Regular.ttf")
- Vérifie la disponibilité de la fonction imagettftext
- Fournit une solution de rechange aux polices intégrées
Le groupe d'experts rend compte de l'état des polices de caractères :
- Pas de polices - avertissement concernant un répertoire fonts/ vide
- Liste des produits disponibles - sélection parmi les polices TTF détectées
- La police n'existe pas - erreur de validation à l'entrée
Si une police TTF n'est pas disponible, le module utilise :
- Police GD intégrée (taille 5 - la plus grande disponible)
- Recalcul automatique de la position du texte
- Conservation de tous les autres paramètres
Conseil
Pour ajouter une nouvelle police, il suffit de télécharger le fichier TTF dans le répertoire fonts/ et d'actualiser la page de configuration. La police apparaîtra automatiquement dans la liste de sélection. Nous recommandons d'utiliser des polices dont la licence autorise un usage commercial.
12 Dépannage
Les filigranes ne sont pas ajoutés aux nouveaux produits- Vérifier si le module est activé dans les paramètres généraux
- S'assurer que la licence est active
- Vérifiez que vous avez sélectionné les bons types de vignettes
- Vérifier que l'extension GD est installée
- Vérifier les droits d'écriture sur les répertoires img/.
- Vérifier les limites de mémoire de PHP (recommandé : min. 512MB)
- Augmenter le temps d'exécution maximum en PHP (recommandé : 300 secondes)
- Vérifier que toutes les images des produits sont correctes
- Utiliser CRON au lieu d'un navigateur pour les grandes boutiques
- Consultez les journaux du module pour connaître les détails de l'erreur
- Vérifier les droits d'écriture sur le répertoire modules/cc_ps_watermark/backups/.
- Assurez-vous qu'il y a suffisamment d'espace sur le disque
- Vérifier que le répertoire backups/ a été créé lors de l'installation
- Vérifier l'intégrité de la base de données (table cc_ps_watermark_backups)
- Vérifier les journaux du module pour les erreurs liées aux sauvegardes
- Vérifier que le chemin d'accès à PHP dans CRON est correct
- Vérifier les permissions du fichier cron.php (755)
- S'assurer que le module est actif lors de l'exécution du CRON
- Vérifier les erreurs dans les journaux du serveur
- Tester l'exécution de cron.php manuellement via SSH
- Vérifier que l'extension GD prend en charge les caractères TTF (fonction imagettftext).
- Assurez-vous que les fichiers de police portent l'extension .ttf.
- Vérifier les droits de lecture des fichiers de police (644)
- Vérifier que le chemin d'accès à la police est correct
- Vérifier que le fichier de police n'est pas corrompu
- Vérifier la taille des sauvegardes dans l'onglet "Sauvegardes".
- Envisager de supprimer les anciennes sauvegardes
- Optimiser les images de produits avant d'ajouter des filigranes
- Utiliser la compression d'image dans les paramètres de PrestaShop
- Nettoyer régulièrement les sauvegardes inutiles
Erreur
Si vous rencontrez des problèmes insolubles avec le module, assurez-vous que vous utilisez la dernière version et que votre boutique PrestaShop est à jour. Vérifiez également que vous disposez de suffisamment de ressources serveur (RAM, CPU, espace disque). En cas de difficultés, veuillez contacter le service d'assistance COCOS via la page suivante cocos.codes/support.
13. LES FAQ
Puis-je restaurer les images originales après avoir ajouté des filigranes ?Oui, si les sauvegardes sont activées. Utilisez la fonction "Restaurer toutes les copies" dans l'onglet "Sauvegardes" ou restaurez les copies d'un produit spécifique.
À quelle fréquence dois-je régénérer les figurines ?
Cela dépend de la fréquence à laquelle les produits sont ajoutés. Pour les boutiques actives, nous recommandons une régénération quotidienne par CRON. Pour les boutiques moins actives, nous recommandons une régénération hebdomadaire ou selon les besoins.
Puis-je utiliser mes propres polices TTF ?
Oui, téléchargez les fichiers TTF dans le répertoire /modules/cc_ps_watermark/fonts/ et ils apparaîtront automatiquement dans la liste de sélection. Assurez-vous que vous avez le droit d'utiliser les polices à des fins commerciales.
Que se passe-t-il si je désactive les sauvegardes ?
Les images seront modifiées directement sans possibilité de restaurer les versions originales. Nous ne recommandons pas de désactiver cette option.
Puis-je ajouter un filigrane uniquement à certains types de vignettes ?
Oui, dans les paramètres, vous pouvez sélectionner les types de vignettes spécifiques que vous souhaitez marquer. Les types non sélectionnés restent inchangés.
Comment vérifier que CRON fonctionne correctement ?
Vérifiez l'onglet "Logs" après l'heure d'exécution programmée de CRON. Des entrées de régénération devraient apparaître. Vous pouvez également tester manuellement l'appel à cron.php.
Puis-je modifier la position du filigrane pour différents types de vignettes ?
Actuellement, la position est globale pour tous les types de vignettes. Des positions distinctes pour les différents types nécessitent une modification du code.
Quels sont les formats d'image pris en charge pour le filigrane ?
Les formats PNG, JPG, JPEG et GIF sont pris en charge. Nous recommandons le format PNG avec transparence pour de meilleurs résultats.
Puis-je utiliser le module sur une boutique contenant des milliers de produits ?
Oui, mais nous recommandons d'utiliser CRON pour régénérer et surveiller les ressources du serveur. Les grandes boutiques peuvent avoir besoin d'augmenter les limites de PHP.
Que signifie "L'image a déjà un filigrane" dans les journaux ?
Le système garde la trace des images qui ont déjà été traitées et n'ajoute pas le filigrane à nouveau. Il s'agit d'un comportement normal qui permet d'éviter les doublons.
Puis-je exporter les journaux du module ?
Il n'y a actuellement pas de fonction d'exportation intégrée, mais tous les journaux se trouvent dans la table cc_ps_watermark_log et peuvent être exportés via phpMyAdmin.
Comment supprimer tous les filigranes de la boutique ?
Utilisez la fonction "Restaurer toutes les copies" dans l'onglet "Sauvegardes". Cette fonction permet de restaurer les images originales à partir de toutes les sauvegardes.
Le module affecte-t-il les performances de l'atelier ?
En fonctionnement normal, l'impact est minime. Le traitement de l'image n'a lieu que lors de l'ajout ou de la mise à jour de produits ou lors de la régénération.
Que se passe-t-il lorsque la licence expire ?
Les fonctions de base fonctionneront, mais les options avancées telles que AJAX, les sauvegardes et la régénération peuvent être limitées. Nous vous recommandons de renouveler votre licence.
Puis-je utiliser le module dans un environnement de test ?
Oui, la licence autorise également l'utilisation sur des sous-domaines de test et des environnements de développement locaux conformément aux conditions de la licence.
Quelle est la taille des fichiers de police que je peux utiliser ?
Il n'y a pas de limite stricte, mais nous recommandons d'utiliser des polices de caractères d'une taille maximale de 2 Mo. Les fichiers plus volumineux peuvent affecter les performances lors du traitement des images.
Puis-je utiliser des emoji ou des caractères spéciaux dans le texte du filigrane ?
Oui, si la police TTF utilisée prend en charge les caractères en question. Les polices GD intégrées ont une prise en charge limitée des caractères spéciaux.
Que signifie l'erreur "Extension GD non disponible" ?
Cela signifie que l'extension GD pour PHP, nécessaire au traitement des images, n'est pas installée sur le serveur. Veuillez contacter votre administrateur de serveur.
Puis-je ajouter automatiquement des filigranes aux images téléchargées via FTP ?
Le module traite automatiquement les images uniquement pour les opérations via le panneau PrestaShop. Les images ajoutées via FTP nécessitent la régénération des vignettes.
Comment modifier la taille maximale de l'image filigrane téléchargée ?
La limite de 2 Mo est définie dans la classe ImageHelper. Le changement nécessite de modifier le code et d'augmenter les limites de PHP upload_max_filesize.
Succès
Le module CC PrestaShop Watermark est un outil professionnel pour protéger les images de produits dans les boutiques en ligne. Grâce à un système de sauvegarde avancé, à l'automatisation des processus et à un système d'enregistrement détaillé, il permet une gestion sûre et efficace des filigranes sur toutes les images de produits.
